home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Vk / VkFileSelectionDialog.z / VkFileSelectionDialog
Encoding:
Text File  |  2002-10-03  |  8.2 KB  |  199 lines
  1.  
  2.  
  3.  
  4. VVVVkkkkFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnDDDDiiiiaaaalllloooogggg((((3333xxxx))))                            VVVVkkkkFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnDDDDiiiiaaaalllloooogggg((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      VkFileSelectionDialog - Dialog manager for file selection dialogs
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      VkDialogManager : VkComponent : VkCallbackObject
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <Vk/VkFileSelectionDialog.h>
  16.  
  17. PPPPUUUUBBBBLLLLIIIICCCC PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLL SSSSUUUUMMMMMMMMAAAARRRRYYYY
  18.    CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr////DDDDeeeessssttttrrrruuuuccccttttoooorrrr
  19.            VkFileSelectionDialog(const char* name);
  20.            virtual void ~VkFileSelectionDialog(void);
  21.  
  22.  
  23.    AAAAcccccccceeeessssssss FFFFuuuunnnnccccttttiiiioooonnnnssss
  24.            const char* fileName(void);
  25.  
  26.  
  27.    CCCCoooonnnnttttrrrroooolllllllliiiinnnngggg tttthhhheeee DDDDiiiiaaaalllloooogggg
  28.            void setDirectory(const char* directory);
  29.            void setFilterPattern(const char* pattern);
  30.  
  31.  
  32. PPPPRRRROOOOTTTTEEEECCCCTTTTEEEEDDDD PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLL SSSSUUUUMMMMMMMMAAAARRRRYYYY
  33.    AAAAcccccccceeeessssssss ffffuuuunnnnccccttttiiiioooonnnnssss
  34.            XmFileSelectionBoxCallbackStruct* callData(void);
  35.  
  36.  
  37. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  38.           This class displays a Motif file selection dialog using the caching
  39.           facilities of the VkDialogManager class. Applications can use the
  40.           global dialog _t_h_e_F_i_l_e_S_e_l_e_c_t_i_o_n_D_i_a_l_o_g to prompt users for file names.
  41.  
  42.  
  43.  
  44. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  45.    ccccaaaallllllllDDDDaaaattttaaaa(((())))
  46.            XmFileSelectionBoxCallbackStruct* callData(void);
  47.  
  48.  
  49.           Returns the file selection dialog's callData structure.  This
  50.           structure is filled in by the file selection dialog with every
  51.           callback.
  52.  
  53.    VVVVkkkkFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnDDDDiiiiaaaalllloooogggg(((())))
  54.            VkFileSelectionDialog(const char* name);
  55.  
  56.  
  57.           Initializes a VkFileSelectionDialog object.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVkkkkFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnDDDDiiiiaaaalllloooogggg((((3333xxxx))))                            VVVVkkkkFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnDDDDiiiiaaaalllloooogggg((((3333xxxx))))
  71.  
  72.  
  73.  
  74.    ~~~~VVVVkkkkFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnDDDDiiiiaaaalllloooogggg(((())))
  75.            virtual void ~VkFileSelectionDialog(void);
  76.  
  77.  
  78.           Frees storage associated with the a VkFileSelectionDialog.  The
  79.           global file selection dialog _t_h_e_F_i_l_e_S_e_l_e_c_t_i_o_n_D_i_a_l_o_g should not be
  80.           freed.
  81.  
  82.    cccchhhhaaaarrrr****(((())))
  83.            const char* fileName(void);
  84.  
  85.  
  86.           Returns the filename selected by the user.  This string should not
  87.           be freed by the application.
  88.  
  89.    sssseeeettttDDDDiiiirrrreeeeccccttttoooorrrryyyy(((())))
  90.            void setDirectory(const char* directory);
  91.  
  92.  
  93.           Sets current directory of the dialog.
  94.  
  95.    sssseeeettttFFFFiiiilllltttteeeerrrrPPPPaaaatttttttteeeerrrrnnnn(((())))
  96.            void setFilterPattern(const char* pattern);
  97.  
  98.  
  99.           Sets the filter pattern used by the dialog to determine which
  100.           filenames are displayed in the list box.
  101.  
  102. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  103.       #include <iostream.h>
  104.       #include <Vk/VkFileSelectionDialog.h>
  105.  
  106.       // ...
  107.  
  108.       theFileSelectionDialog->setDirectory("/usr/tmp");
  109.  
  110.       if(theFileSelectionDialog->postAndWait( )
  111.                    == VkDialogManager::OK)
  112.            cout << "File name "
  113.                 << theFileSelectionDialog->fileName()
  114.                 << '0 << flush;
  115.  
  116. IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  117.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkDDDDiiiiaaaallllooooggggMMMMaaaannnnaaaaggggeeeerrrr
  118.           show(), hide(), prepost(),
  119.            setTitle(), setButtonLabels(), unpost(), unpostAll(),
  120.           centerOnScreen(), lastPosted(), post(), postModal(), postBlocked(),
  121.           postAndWait(), _action, _showOK, _showCancel, _showApply,
  122.           _allowMultipleDialogs, _minimizeMultipleDialogs, prepostCallback
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. VVVVkkkkFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnDDDDiiiiaaaalllloooogggg((((3333xxxx))))                            VVVVkkkkFFFFiiiilllleeeeSSSSeeeelllleeeeccccttttiiiioooonnnnDDDDiiiiaaaalllloooogggg((((3333xxxx))))
  137.  
  138.  
  139.  
  140.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkCCCCoooommmmppppoooonnnneeeennnntttt
  141.           installDestroyHandler(), removeDestroyHandler(), widgetDestroyed(),
  142.           setDefaultResources(), getResources(), callCallbacks(),
  143.           VkComponent(), manage(), unmanage(), baseWidget(), okToQuit(),
  144.           _name, _baseWidget, _w, deleteCallback
  145.  
  146.  
  147.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkCCCCaaaallllllllbbbbaaaacccckkkkOOOObbbbjjjjeeeecccctttt
  148.           callCallbacks(), addCallback(), removeCallback(),
  149.           removeAllCallbacks()
  150.  
  151.  
  152. VVVVIIIIEEEEWWWWKKKKIIIITTTT 2222....1111 CCCCHHHHAAAANNNNGGGGEEEESSSS
  153.      In multi-screen enabled applications or components, references to
  154.      _t_h_e_F_i_l_e_S_e_l_e_c_t_i_o_n_D_i_a_l_o_g will only be valid for the _d_e_f_a_u_l_t screen in the
  155.      application.  The following new function API will return the
  156.      VkFileSelectionDialog associated with the appropriate screen and should
  157.      be used instead of _t_h_e_F_i_l_e_S_e_l_e_c_t_i_o_n_D_i_a_l_o_g;
  158.  
  159.  
  160.            VkFileSelectionDialog *getAppFileSelectionDialog(VkComponent *comp);
  161.  
  162.  
  163. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  164.      SgFileSelectionBox(3X), XmFileSelectionBox(3X)
  165.      VkDialogManager, VkComponent
  166.      _V_i_e_w_K_i_t _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e
  167.      _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m, DEC Press, Bob Sheifler and Jim Gettys
  168.      _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m _T_o_o_l_k_i_t, DEC Press, Paul Asente and Ralph Swick
  169.      _T_h_e _O_S_F/_M_o_t_i_f _P_r_o_g_r_a_m_m_e_r_s _R_e_f_e_r_e_n_c_e, Prentice Hall, OSF
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.